home *** CD-ROM | disk | FTP | other *** search
/ Freaks Macintosh Archive / Freaks Macintosh Archive.bin / Freaks Macintosh Archives / IRC / Bots⁄Utilities / ShadowBot1.0b8.sit / ShadowBot1.0b8 / ShadowBot 1.0b8 Docs next >
Text File  |  1996-05-11  |  8KB  |  124 lines

  1. ShadowBot1.0b8
  2. © 1996 John Bafford, all rights reserved.
  3.  
  4. This is the second public beta release of ShadowBot.
  5.  
  6. ShadowBot is shareware, $15. To register, send cash, check, or money order to:
  7. ShadowBot Registration
  8. c/o John Bafford
  9. 6 Cedar Springs Ct.
  10. Baltimore, MD 21228
  11.  
  12. Testing
  13. •ShadowBot needs to be tested in a BUSY channel, with lots of activity, for a long period of time. I cannot do this; I don't have a 24/7 connection.
  14. •Please let me know where you plan to test ShadowBot (network, server, and channel). Please follow server rules if they request that no bots be present.
  15. •It is recommended that you add me (!add DShadow *!*DShadow@*.bcpl.lib.md.us 100 1) to the bot userlist in case of problems.
  16. • Test everything; any bugs found must be squashed. :-)
  17. • With a clone, to avoid getting yourself lagged, try flooding the bot in various ways (mode changes, topic changes, channel/private messages, CTCP requests, beeps, etc). Let me know if you think the bot is too harsh or too leinent in its kicks for flooding.
  18. • ShadowBot, at least for me, seems happy with 700k of RAM. It shouldn't need much more than this, but if it does, feel free to give it whatever you think it needs. If you run into a memory problem, let me know. 700k should be sufficient for one channel and several DCCs since it only retains 10k of text per channel/DCC CHAT connection.
  19. • ShadowBot will quit if it has less than about 10k of free RAM.
  20.  
  21. Updating ShadowBot
  22. If you were the recipient of the earlier beta releases, follow the directions below to update your ShadowBot files to work with ShadowBot 1.0b7.
  23. • The plugins file now goes in the plugins folder and the path to the plugins folder is set through the Files command in the bot menu. Delete the first line in the plugins file.
  24. • The Countries file now goes in the plugins folder and can be modified while ShadowBot is open.
  25. • Delete the Settings and Shitlist files; their structure have changed. (Only necessary if you haven't yet updated to 1.0b6.)
  26.  
  27. Help Needed
  28. • I need icons for the ShadowBot application, Settings, Userlist, and Shitlist files. If you can draw some cool icons, please send them to me.
  29. • I write pathetic manuals. If you would like to write the manual for ShadowBot, let me know.
  30.  
  31. Setup
  32. To open ShadowBot, you must have a live TCP connection to the Internet.
  33.  
  34. Select the Connection Settings item from the Bot menu and enter the default server and port, the bot’s nick, user, username, default channel, and command character. Check the Auto-connect on startup box if you want ShadowBot to initiate a connection when it starts up. Select the MODE +d button if you want ShadowBot to go deaf as soon as it logs on.
  35.  
  36. In Owner Setup, enter your usual nick and your user@host. Optionally, you can enter your email address, an infoline, and your realname.
  37.  
  38. In Channel Modes, set the modes you want your channel to be locked at. If you don’t care about the setting for a specific mode, click the ignore button for the mode.  If you want the mode locked off, click the Off button. If you want it locked on, click the on button. If you want the topic to be protected, click the Protect Topic button and enter a topic.
  39.  
  40. Go to the Files command in the Bot menu and enter the full paths to the Plugins and DCC folders. In order for plugins to work, the Plugins path must be set correctly, and in order for ShadowBot to DCC files, the DCC path must be set correctly.
  41.  
  42. Plugins
  43. Plugins are script or data files that allow additional commands to be added to ShadowBot. These script files may include any command that ShadowBot understands. More information is given in the plugins.dat file and the sample plugin files.
  44.  
  45. Changes in 1.0b8
  46. • Fixed a really stupid bug that would cause ShadowBot to crash almost anytime someone not on the userlist typed a command.
  47. • New plugin type: LIST: NOTICEs the lines of a file to the person who types the command
  48. • Allow modification of infoline time and tempban time
  49.  
  50. Added Commands:
  51. IDENT password
  52. if a password is required, this recognizes the user
  53. PWD password
  54. sets the ident password; if 'NONE', password is cleared
  55.  
  56. Changes in 1.0b7
  57. • ShadowBot no longer returns an ERRMSG CTCP response, which means that ShadowBot will only reply to valid CTCP commands.
  58. • Fixed the code that caused the ERRMSG floods in the older (pre-2.3b30ish) copies of Ircle. This also slightly speeds up processing of possible CTCP commands, as the bot only goes through the CTCP checking loop once, whereas before, it would always execute at least part of it twice.
  59. • ShadowBot can be configured to ping you when you enter a channel, tell you your lag, and kick you if your access is low and you have too much lag.
  60. • Fixed the !seen <botname> bug again; didn't fix it right the first time.
  61. • The plugins.dat file now goes into the plugins folder.
  62. • The plugins folder path is set from the Files command in the Bot menu.
  63. • The plugins.dat file can now be modified while the bot is running.
  64. • The Countries file now goes in the plugins folder and can be modified while ShadowBot is open.
  65. • $FROM in plugins is translated to the nick of the user who sent the command to the bot.
  66. • $BOTNICK in plugins is translated to the bot's nick.
  67. • The Help window is now displayed. (I forgot to make allowances for the fact that creating a message window no longer displayed it.) I suppose now, I'll have to figure some way of putting text from the Help file into the help window. :-)
  68. • If you use !EMAIL or !INFOLINE without an argument, it now displays your address/infoline.
  69. • The FT() (number of DCC xfers) in the statusbar is now DCC() and shows the number of open DCC connections.
  70. • If a file named "JOIN #channel" or "LEAVE #channel" is put in the plugins folder, the bot sends them that message when they join or leave the channel. NOTE: These files must be straight text files with none of the plugin substitution strings.
  71. • Added Save Data Files command in the file menu.
  72.  
  73. Added commands:
  74. CPING nick - Pings someone and tells you their lag.
  75. INVITE nick - Invites someone into the channel.
  76. SEND nick file - Sends a file that is in the DCC folder. NOTE: if called from a script, SEND does not check to make sure the person running the script has the proper access (to facilitate setting the bot up as a file server).
  77.  
  78. Changes in 1.0b6
  79. • Added configuration for access levels in the Bot menu.
  80. • If someone is kicked for flooding, an entry is added to the shitlist at level 0. If they flood two more times within a week, they are shitlisted with a shitlevel of two (bankick on entry).
  81.  
  82. Added commands:
  83. JOIN - Join the channel
  84. LEAVE - Leave the channel
  85.  
  86. Changes in 1.0b5
  87. • Fixed a bug that caused portions of the main preferences file to be messed up.
  88. • The bot now recognizes !seen <botname> and responds appropriately. (Would previously only respond appropriately if you did a !seen on "ShadowBot")
  89.  
  90. Added commands:
  91. MSHITLEVEL nick|userAtHost shitLevel - Changes someone's shitlist level.
  92. MSHITDAYS nick|userAtHost numDays - Makes the shitlist entry expire in numDays days.
  93. MSHITREASON nick|userAtHost reason - Modify the reason in a shitlist entry.
  94. CYCLE seconds - Causes the bot to leave the current channel and rejoin seconds later. If seconds is zero or not present, the bot rejoins immediately.
  95.  
  96. Still to do
  97. finish protection of added users
  98. strict opping
  99. don't allow shitlisted ops
  100. server list
  101. !nick
  102. disconnect from server
  103. DCC get
  104. non-DCC command output goes to open DCC connection
  105. auto-ignore flooders
  106. make icons for ShadowBot and its data files
  107.  
  108. Special thanks to
  109. Olaf Titz- for writing Ircle 1.5.1, which ShadowBot is based on
  110. Neuro - the startup screen
  111. Stimmpy, Possible - unending torture in #DShadow
  112. PowerUser, MacJedi, Possible, Melkor, Tandronis- beta testers
  113. ChatNet- for providing a non-lagged testing ground for ShadowBot
  114. UnderNet- for providing a lagged-to-hell testing ground for the lag kicking feature
  115.  
  116. How to contact me
  117. Email: jbafford@mail.bcpl.lib.md.us
  118. IRC: Undernet and ChatNet: DShadow
  119. Snail Mail: John Bafford
  120.                                         6 Cedar Springs Ct.
  121.                                         Baltimore, MD 21228
  122.  
  123. The Fine Print
  124. No warranty is provided. Use at your own risk. What else do you want from a disclaimer?